Generate-Synchronous

Overview

The Generate-Synchronous operation is used to request document processing based on transaction data included in the request. This operation is a synchronous call that takes transaction data, a Content URI, and an account ID (AccountID) for the calling application and returns the transaction ID, status information, as well as the generated package documents.

Table 1. Method
Method URL Description
POST /api/v1/Document/account/{accountId}/generate-synchronous The POST method submits the accountId as part of the Generate call
Table 2. Parameters
Name Type Constraints Description
accountId integer required The account used to associate to the request.

Sample Request

{
    "generate": {
        "request": {
            "daysToExpire": 0,
            "documentFormat": "PDF",
            "transactionData": "PFR4biB4bWxucz0iaHR0c",
            "contentIdentifier": "BaseLibrary.PKG.Default_Default",
            "ancillaryOutput": [
                {
                    "outputType": "Barcode",
                    "barcode": {
                        "type": "barcode2D",
                        "pattern": "%BRCD%,2200478271,DP_CLOSE-2020-05-20T03:40:27.69032-2200478271,%page%,%totalpages%",
                        "horizontalAlignment": "Right"
                    }
                },
                {
                    "outputType": "Watermark",
                    "watermark": {
                        "text": "Sample",
                        "rotate": true,
                        "location": "Center"
                    }
                }
            ],
            "attachmentPosition": "Beginning",
            "delivery": {
                "deliveryHold": true,
                "deliveryMode": "DirectToPaper",
                 "recipients": [
                    {
                        "name": "borrower one",
                        "addressLine1": "123 main street",
                        "addressLine2": "apt 4",
                        "city": "Fargo",
                        "state": "ND",
                        "zip": "58102",
                        "countryCode": "USA",
                        "mailingMethod": [
                            "USPSFirstClass","FedExStandardOvernight"
                        ]
                    },                    {
                        "name": "borrower two",
                        "addressLine1": "321 main street",
                        "addressLine2": "apt 5",
                        "city": "Cold Spring",
                        "state": "MN",
                        "zip": "56320",
                        "countryCode": "USA",
                        "mailingMethod": [
                            "USPSFirstClass"
                        ]
                    }
                  ],
                "returnAddress": {
                    "name": "WKFS",
                    "businessName": "WKES businessName",
                    "addressLine1": "6815 Saukview",
                    "addressLine2": "suite 100",
                    "city": "St Cloud",
                    "state": "MN",
                    "zip": "56301",
                    "countryCode": "BBB"
                },
                "fiPreConsent": true
            }
        }
    }
}
Note: the </transactionData> element must consist of base64 data.

Sample Response

{
  "generate": {
    "request": {
      "documentFormat": "PDF",
      "documentsToGenerate": [
        {
          "documentID": "string",
          "format": "PDF",
          "ancillaryOutput": [
            {
              "outputType": "Barcode",
              "watermark": {
                "imageURL": "string",
                "text": "string",
                "rotate": true,
                "location": "Top"
              },
              "setEncryption": {
                "strength128Bits": true,
                "passwords": {
                  "user": "string",
                  "owner": "string"
                },
                "permissions": {
                  "allowPrinting": true,
                  "allowModifyContents": true,
                  "allowCopy": true,
                  "allowModifyAnnotations": true,
                  "allowScreenReaders": true,
                  "allowFillIn": true,
                  "allowAssembly": true,
                  "allowDegradedPrinting": true
                }
              },
              "barcode": {
                "type": "Barcode128",
                "pattern": "string",
                "useCoverPage": true,
                "firstPageOnly": true,
                "horizontalAlignment": "Left"
              },
              "eSignatureAndFieldSupport": {
                "eSignatureCoordinatesOnly": true,
                "eSignatureDateSupport": true,
                "eSignatureTooltip": "string",
                "eSignatureInitialsTooltip": "string",
                "nonSignatureFieldCoordinatesOnly": true,
                "eSignatureWKES": true
              },
              "logo": {
                "image": "string",
                "heightInInches": 0,
                "widthInInches": 0,
                "placement": "AllPages",
                "justification": "Left",
                "alternateText": "string"
              }
            }
          ]
        }
      ],
      "daysToExpire": 0,
      "transactionData": "string",
      "contentIdentifier": "string",
      "callback": {
        "authorization": {
          "authType": "HTTPBasic",
          "user": "string",
          "password": "string",
          "token": "string"
        },
        "url": "string"
      },
      "passthroughIdentifier": "string",
      "ancillaryOutput": [
        {
          "outputType": "Barcode",
          "watermark": {
            "imageURL": "string",
            "text": "string",
            "rotate": true,
            "location": "Top"
          },
          "setEncryption": {
            "strength128Bits": true,
            "passwords": {
              "user": "string",
              "owner": "string"
            },
            "permissions": {
              "allowPrinting": true,
              "allowModifyContents": true,
              "allowCopy": true,
              "allowModifyAnnotations": true,
              "allowScreenReaders": true,
              "allowFillIn": true,
              "allowAssembly": true,
              "allowDegradedPrinting": true
            }
          },
          "barcode": {
            "type": "Barcode128",
            "pattern": "string",
            "useCoverPage": true,
            "firstPageOnly": true,
            "horizontalAlignment": "Left"
          },
          "eSignatureAndFieldSupport": {
            "eSignatureCoordinatesOnly": true,
            "eSignatureDateSupport": true,
            "eSignatureTooltip": "string",
            "eSignatureInitialsTooltip": "string",
            "nonSignatureFieldCoordinatesOnly": true,
            "eSignatureWKES": true
          },
          "logo": {
            "image": "string",
            "heightInInches": 0,
            "widthInInches": 0,
            "placement": "AllPages",
            "justification": "Left",
            "alternateText": "string"
          }
        }
      ],
      "attachments": [
        {
          "attachmentDoc": "string",
          "displayName": "string",
          "instanceFileName": "string",
          "attachmentPosition": "Beginning",
          "passwords": {
            "user": "string",
            "owner": "string"
          }
        }
      ],
      "attachmentPosition": "Beginning",
      },
      "mergeTRIDDocs": true,
      "ezConfig": {
        "orgId": "string",
        "orgName": "string",
        "orgAlias": "string",
        "orgLOB": "string"
      }
    }
  }
}

Generate-Asynchronous Overview

The Generate operation is used to request document processing based on transaction data included in the request. This operation is an asynchronous call that takes transaction data, a Content URI, and an account ID (AccountID) for the calling application and returns the transaction ID, status information, as well as the generated package documents.

Select-Synchronous Overview

The Select - Synchronous operation is used to select documents for immediate processing and retrieve the results of the Select request.